home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 May / Macworld (1998-05).dmg / Games World / Game Utilities / Holy Roller 2.0 / Holy ReadMe! next >
Text File  |  1998-03-03  |  4KB  |  65 lines
  1. Welcome to HolyRoller!2.0
  2.  
  3. This is a simple little program, for gamers mostly, that provides
  4. a working random number generator based on the standard gaming
  5. dice.  To operate, you may select the total number of results by
  6. clicking one of the radio boxes labled x1 through x10. Hit return
  7. or click the roll button to generate that many results.
  8.    For special dice rolls, use the text entry boxes next to the icons.
  9. The icons represent, in order: 4sided, 6sided, 8sided, 10sided,
  10. 12sided and 20sided dice.  Entering a 1 in the text field generates
  11. a random number from 1 to the number of sides. Entering any other
  12. number in these fields causes the Roller to generate an approprate
  13. random number that many times and add the results.  For example,
  14. if you click the d6 icon and enter 3, it will generate a ramdom
  15. number between one and six, do it again, and a third time, then
  16. add all three results together and display that result. If you
  17. clicked a different radio box than x1, it will repeat the process
  18. that many times.
  19.     The bottom two boxes allow users to create custom die rolls
  20. not found in standard dice.  Say you want to generate a random 
  21. number from 1 to 17. Enter a 1 in the left box (for the number of
  22. dice to roll) and a 17 in the box under the icons (for the "size" of 
  23. the die).  If you want a curved number from 2 to 98, divide 98 by 2 = 49; 
  24. enter 2 in the left box (for the number of dice to roll) and 49 in the right one.
  25.  
  26. Tech notes:
  27. This version may have hidden bugs in it, so let me know if you find
  28. any event that is a lttle unusual. It's had some testing on my
  29. Classic, but I know how to work the darn thing.
  30. Version 1.1b
  31. I'm still calling this beta since I feel that full testing cannot be done 
  32. by the creator.  One bug I think is fixed, is the variable die occasionally 
  33. flipping over to a different number.  Also, I added the ability to shut off 
  34. the die rolling sound.  This version is dedicated to Stephan Johnson of MIT 
  35. for his helpful letter.
  36. Version 2.0
  37. Well, I finally got around to cleaning up the code, and I think it works superbly.  
  38. I've found that it absolutely rocks on the Classic compared to earlier versions.  
  39. Code is still toolbox clean and will run native.  I added a preference file.  Also, 
  40. thanks to the people that bothered to send a letter, I've modified the random 
  41. function to be closer to fully random (take v1.1, start it and roll the d6 a couple 
  42. of times and record the results, then restart the program and do it again, the 
  43. results are the same).
  44. The Preferences menu allows you to turn the sound on or off and keep it that
  45. way.  The auto-roll function starts the program having rolled the appropriate
  46. die chosen in the radio buttons, then resets the program to last used values
  47. (so if you leave the program on 3d6x6 but the auto roll is set to d4, the program
  48. will roll the d4 with appropriate modifiers on startup, then set you up to roll 
  49. the 3d6x6).  The save die quantity setting automatically comes on with auto-roll,
  50. but you can turn it off if you wish.  This is the option that keeps the number of 
  51. dice and the number of times to roll in the preferences.
  52. Warning, this version may have bugs, but I'm getting better at finding and killing 'em.
  53.  
  54. Shareware:
  55. This software is shareware.  You are allowed to distribute it
  56. freely to anyone or anywhere so long as it is unchanged and
  57. includes this file.  If you notice bugs, have comments, or feel like
  58. sending a couple of bucks, here's the info:
  59.  
  60.     tedward@m-net.arbornet.org
  61.  
  62.    Edward J LeCouteur
  63.      5030 Whitsett #8
  64.      N. Hollywod, CA 91607
  65.